home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Mousetools / PortSwitch / Documentation / PortSwitch.Doc < prev    next >
Encoding:
Text File  |  1996-09-27  |  7.5 KB  |  259 lines
  1.  
  2.                                Port Switch v1.2
  3.                           © Software Ambience 1995/96
  4.  
  5.                              Kickstart 2.0 version
  6.                          Programmed by Steve Sloggett
  7.  
  8. ----------
  9.  Contents
  10. ----------
  11.  
  12.     1. Distribution
  13.     2. Introduction
  14.     3. Requirements
  15.     4. Usage
  16.     5. History
  17.     6. Acknowledgements
  18.     7. Software Ambience
  19.  
  20. -----------------
  21.  1. Distribution
  22. -----------------
  23.  
  24. Disclaimer
  25. ----------
  26.  
  27.     This software and information is provided "as is". No representations
  28. or warranties are made with respect to the accuracy, reliability,
  29. performance, currentness, or operation of this software and information,
  30. and all use is at your own risk. The author assumes no responsibility or
  31. liability whatsoever with respect to your use of this software and
  32. information.
  33.  
  34. Distribution
  35. ------------
  36.  
  37.     This program is freeware. You may copy this program freely but you
  38. cannot charge more than a nominal fee for copying. The distribution must
  39. remain complete and unaltered, although permission is given to crunch or
  40. archive the complete distribution. Magazines are permitted to distribute
  41. this program on their disks providing they inform the author, stating the
  42. most recent version in their possession, so the author can ensure that the
  43. version distributed is the current release.
  44.     The source code can be used as part of any program provided that I am
  45. given credit for my work by means of the following statement:
  46.  
  47.         Part of this program is based upon Port Switch v1.2 which is
  48.         © Software Ambience 1995/96
  49.  
  50.     I would also appreciate being notified of this fact.
  51.     The following files should be contained within the distribution. If any
  52. are missing, please contact the author for the complete distribution. The
  53. sizes quoted are for the file when it has not been crunched.
  54.  
  55.         Port Switch (dir)
  56.             Documentation (dir)
  57.                 PortSwitch.Doc
  58.                 PortSwitch.Guide
  59.             Source (dir)
  60.                 PortSwitch.C
  61.             PortSwitch
  62.  
  63.     If you have any complaints, suggestions, bug reports, requests for
  64. updates, samples of your work, or spare cash, please send them to:
  65.  
  66.         Mail: Steve Sloggett
  67.               55 North Road East
  68.               Plymouth
  69.               Devon
  70.               England
  71.               PL4 6AN
  72.  
  73.         Internet: s.sloggett@plymouth.ac.uk
  74.                   steve@area51.upsu.plym.ac.uk
  75.  
  76.                   PGP encryption available
  77.  
  78.         World Wide Web: http://area51.upsu.plym.ac.uk/~steve
  79.  
  80. -----------------
  81.  2. Introduction 
  82. ------------------
  83.  
  84.     Why did I write Port Switch? Well... due to excessive wear to
  85. the mouse port on my A1200, a pin broke off and rendered my mouse useful
  86. only if I wanted to move the pointer horizontally :-)
  87.     Obviously, this wasn't a good thing. So, I wrote this program as a
  88. short-term way of getting my mouse operational again.
  89.     Please be aware, however, that it can only do as much as you could
  90. using the keyboard mouse emulation:
  91.  
  92.         o Buttons
  93.  
  94.             Hold down an Amiga key and press the Left-Alt or Right-Alt
  95.             keys for the appropriate button
  96.  
  97.         o Movement
  98.  
  99.             Hold down an Amiga key and use the Cursor keys, and to
  100.             increase the movement speed, hold down the Shift key
  101.  
  102. -----------------
  103.  3. Requirements
  104. -----------------
  105.  
  106.     This program requires Kickstart 2.0 or higher. If it is not present, the
  107. program will not work.
  108.  
  109. ----------
  110.  4. Usage
  111. ----------
  112.  
  113.     This program should be used from the CLI or Shell. The syntax is:
  114.  
  115.         PORT/N/A
  116.  
  117.     This is the port number that the mouse is to be controlled from. This
  118. can either be 0 or 1. If this is not supplied, the program assumes the
  119. default mouse port, 0.
  120.     If, for example, you wanted to change the port to port 1, simply type:
  121.  
  122.         PortSwitch 1
  123.  
  124.     In reponse, providing if it was successful, you will see:
  125.  
  126.         Port Switch v1.2 © Software Ambience 1995/96 (Freeware)
  127.         Programmed by Steve Sloggett
  128.  
  129.         Mouse control port is now changed
  130.  
  131. ------------
  132.  5. History
  133. ------------
  134.  
  135.     Below is a list, in ascending order, of all the versions to date of
  136. this program with information as to what has changed.
  137.  
  138.         o 1.0 (28th December 1995)
  139.  
  140.             Initial version.
  141.  
  142.         o 1.1 (29th December 1995)
  143.  
  144.             Added command line parameters and various code improvements.
  145.  
  146.         o 1.2 (17th February 1996)
  147.  
  148.             Miscellaneous changes.
  149.  
  150. Configurations
  151. --------------
  152.  
  153.     This program has been fully tested on the configurations listed below:
  154.  
  155.         o A500 Plus with a 68000 processor, Kickstart 2.04 and 1 megabyte
  156.           of chip ram
  157.  
  158.         o A1200 with a 68030 processor and MMU, Kickstart 3.0, 2 megabytes
  159.           of chip ram, 4 megabytes of fast ram, an external disk drive,
  160.           and a 250 megabyte PCMCIA external hard drive.
  161.  
  162.         o A1200 with a 68020 processor, Kickstart 3.0, 2 megabytes of chip
  163.           ram, an external disk drive, and a 130 megabyte PCMCIA external
  164.           hard drive, and a CD-ROM drive.
  165.  
  166. ---------------------
  167.  6. Acknowledgements
  168. ---------------------
  169.  
  170.     Without the following people, this program would never have existed. I
  171. wish to extend many thanks to:
  172.  
  173.         o Ross O'Connor
  174.  
  175.             For the use of his A1200 for testing.
  176.  
  177.         o James Lester
  178.  
  179.             For the use of his A500 Plus for testing.
  180.  
  181. ----------------------
  182.  7. Software Ambience
  183. ----------------------
  184.  
  185. Joining Software Ambience
  186. -------------------------
  187.  
  188.     If you wish to join Software Ambience, please send some samples of your
  189.     own work to one of the members below, or visit the Software Ambience
  190.     home page.
  191.  
  192.     If you wish to be notified of future Software Ambience releases and
  193.     updates, send an e-mail message to "s.sloggett@plymouth.ac.uk" with a
  194.     subject of "Subscribe Ambience". The mailing list is sent out very
  195.     infrequently.
  196.  
  197. Current Members
  198. ---------------
  199.  
  200.     o Software Ambience
  201.  
  202.         FTP: area51.upsu.plym.ac.uk/pub/amiga/Software_Ambience
  203.  
  204.         World Wide Web: http://cent1.lancs.ac.uk/~pyc95042
  205.  
  206.     o Steve Sloggett (Programmer)
  207.  
  208.         Mail: 55 North Road East
  209.               Plymouth
  210.               Devon
  211.               England
  212.               PL4 6AN
  213.  
  214.         Internet: s.sloggett@plymouth.ac.uk
  215.                   steve@area51.upsu.plym.ac.uk
  216.  
  217.                   PGP encryption available
  218.  
  219.         World Wide Web: http://area51.upsu.plym.ac.uk/~steve
  220.  
  221.     o Ross O'Connor (Programmer)
  222.  
  223.         Mail: Room A216 Colton
  224.               Furness College
  225.               Lancaster University
  226.               Lancs
  227.               LA1 4YG
  228.  
  229.         Internet: r.oconnor@lancaster.ac.uk
  230.  
  231.         World Wide Web: http://cent1.lancs.ac.uk/~oconnorr
  232.  
  233.     o Carl Wainwright (Programmer)
  234.  
  235.         Internet: wainwrig@amla.lab.fh-ulm.de
  236.  
  237.         World Wide Web: http://area51.upsu.plym.ac.uk/~carlw
  238.  
  239. Steve Sloggett's Public PGP Key
  240. -------------------------------
  241.  
  242.     Below is my public PGP key. If you do not trust this copy, then you
  243.     can get it from me by sending an e-mail message to
  244.     "s.sloggett@plymouth.ac.uk" with a subject of "Send Key".
  245.  
  246. -----BEGIN PGP PUBLIC KEY BLOCK-----
  247. Version: 2.6.3i
  248.  
  249. mQCNAzEmI0IAAAEEAOY5samfgzH5UxWF+F65Vb8MFlDCJmlAYUvX78+NuIDtusYK
  250. npsbZfAm8zffenBfNCg58MJPjEP0ogukqMPKvrMx63PvSghk2CdkwZbl0nSX47yV
  251. uF+hnV4RzUlI2MmpLW2ubmDJ7BQNWAF+u6gFiPDszEC3fr1TNKjMkiGaCMgVAAUR
  252. tCpTdGV2ZSBTbG9nZ2V0dCA8cy5zbG9nZ2V0dEBwbHltb3V0aC5hYy51az6JAJUD
  253. BRAxJiNCqMySIZoIyBUBAZlTA/9+u+z0Kuuqu1Qa1oFxet0GK44uO6JLHFKmBF53
  254. Hb5MPtpbPkENN24nmOTXXhWqoRMA8K7jBH2W8INZTrRCUA51BpWIKf5ZdgpPjWmx
  255. kLbbrz4ikEIMiEARbUKHRUYaqwSi/rZzIz1iMLiAA7s7k3A9b3kXPqFbo5mdfU5M
  256. 1/1psg==
  257. =gdwE
  258. -----END PGP PUBLIC KEY BLOCK-----
  259.